home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / tin.1 < prev    next >
Text File  |  1995-07-25  |  96KB  |  2,047 lines
  1.  
  2.  
  3.  
  4.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           tin, rtin, cdtin, tind - A Netnews reader
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ttttiiiinnnn////rrrrttttiiiinnnn////ccccddddttttiiiinnnn////ttttiiiinnnndddd [ _o_p_t_i_o_n_s ] [ _n_e_w_s_g_r_o_u_p_s ]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           _T_i_n is a full-screen easy to use Netnews reader. It can read
  16.           news locally (i.e. /_u_s_r/_s_p_o_o_l/_n_e_w_s) or remotely (_r_t_i_n or _t_i_n
  17.           -_r option) via a NNTP (Network News Transport Protocol)
  18.           server.  _C_d_t_i_n can read news locally and news archived on
  19.           CD-ROM. It will automatically utilize nov (news overview)
  20.           style index files if available locally or via the nntp xover
  21.           command.
  22.  
  23.           _T_i_n has five separate levels of operation: Group selection
  24.           level, Spooldir selection level, Group level, Thread level
  25.           and Article level.  Use the 'h' (help) command to view a
  26.           list of the commands available at a particular level.
  27.  
  28.           On startup _t_i_n will show a list of the newsgroups found in
  29.           $_H_O_M_E/._n_e_w_s_r_c. An arrow '->' or highlighted bar will point
  30.           to the first newsgroup. Move to a group by using the
  31.           terminal arrow keys (terminal dependent) or 'j' and 'k'.
  32.           Use PgUp/PgDn (terminal dependent) or Ctrl-U and Ctrl-D to
  33.           page up/down.  Enter a newsgroup by pressing RETURN.
  34.  
  35.           The TAB key advances to the next newsgroup with unread
  36.           articles and enters it.
  37.  
  38.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  39.           ----cccc          create/update index files for every group in
  40.                       $_H_O_M_E/._n_e_w_s_r_c or file specified by -f option and
  41.                       mark all articles as read.
  42.  
  43.           ----ffff _f_i_l_e     use the specified file of subscribed to
  44.                       newsgroups in place of $_H_O_M_E/._n_e_w_s_r_c.
  45.  
  46.           ----hhhh          help listing all command line options.
  47.  
  48.           ----HHHH          brief introduction to _t_i_n that is also shown the
  49.                       first time it is started.
  50.  
  51.           ----IIII _d_i_r      directory in which to store newsgroup index
  52.                       files.  Default is $_H_O_M_E/._t_i_n/._i_n_d_e_x.
  53.  
  54.           ----mmmm _d_i_r      mailbox directory to use.  Default is
  55.                       $_H_O_M_E/_M_a_i_l.
  56.  
  57.           ----MMMM _u_s_e_r     mail unread articles to specified user for later
  58.                       reading.  For more information read section
  59.                       Automatic Mailing and Saving New News.
  60.  
  61.  
  62.  
  63.      Page 1                                              March 9, 1994
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  71.  
  72.  
  73.  
  74.           ----nnnn          Only load groups from the active file that are
  75.                       also subscribed to in the users ._n_e_w_s_r_c.  This
  76.                       allows a noticeable speedup when connecting via
  77.                       a slow line.
  78.  
  79.           ----pppp _p_r_o_g_r_a_m  print program with options.
  80.  
  81.           ----qqqq          quick start without checking for new newsgroups.
  82.  
  83.           ----PPPP          purge group index files of articles that no
  84.                       longer exist. Care should be taken when using
  85.                       this command as it stats each and every article
  86.                       in each group that is accessed. On a low speed
  87.                       connection this can have an undisirable effect
  88.                       and it also knocks the hell out of your
  89.                       filesystem.
  90.  
  91.           ----rrrr          read news remotely from the default NNTP server
  92.                       specified in the environment variable NNTPSERVER
  93.                       or contained in the file /_e_t_c/_n_n_t_p_s_e_r_v_e_r.
  94.  
  95.           ----RRRR          read news saved by -S option (not yet
  96.                       implemented).
  97.  
  98.           ----ssss _d_i_r      save articles to directory.  Default is
  99.                       $_H_O_M_E/_N_e_w_s.
  100.  
  101.           ----SSSS          save unread articles for later reading by -R
  102.                       option.  For more information read section
  103.                       Automatic Mailing and Saving New News.
  104.  
  105.           ----uuuu          create/update index files for every group in
  106.                       $_H_O_M_E/._n_e_w_s_r_c or file specified by -f option.
  107.                       This option is disabled if _t_i_n retreives its
  108.                       index files via a NNTP server.
  109.  
  110.           ----UUUU          start _t_i_n in the background to update index
  111.                       files while reading news in the foreground.
  112.                       This option is disabled if _t_i_n retreives its
  113.                       index files via a NNTP server.
  114.  
  115.           ----vvvv          verbose mode for -c -M -S -u and -Z options.
  116.  
  117.           ----wwww          quick mode to post an article and then exit.
  118.  
  119.           ----zzzz          only start _t_i_n if there is any new/unread news.
  120.                       If there is news _t_i_n will position cursor at
  121.                       first group with unread news. Useful for putting
  122.                       in login file.
  123.  
  124.           ----ZZZZ          check if there is any new/unread news and exit
  125.                       with appropriate status.  If -v option is
  126.  
  127.  
  128.  
  129.      Page 2                                              March 9, 1994
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  137.  
  138.  
  139.  
  140.                       specified the number of unread articles in each
  141.                       group is printed.  An exit code 0 indicates no
  142.                       news, 1 that an error occurred and 2 that
  143.                       new/unread news exists.  Useful for writing
  144.                       scripts.
  145.  
  146.           _T_i_n can also dynamically change its options by the 'M' menu
  147.           command.  Any changes are written to $_H_O_M_E/._t_i_n/_t_i_n_r_c.
  148.  
  149.           The index daemon version, _t_i_n_d, only supports the -f, -h, -I
  150.           and -v options.
  151.  
  152.      IIIINNNNDDDDEEEEXXXX FFFFIIIILLLLEEEESSSS
  153.           In order to keep track of threads, _t_i_n maintains an index
  154.           for each newsgroup. There are a number of methods in which
  155.           index files can be created and updated.
  156.  
  157.           The simplest method is that each user creates/updates there
  158.           own index files that are stored in $_H_O_M_E/._t_i_n/._i_n_d_e_x. This
  159.           has the advantage that any user can compile and install _t_i_n,
  160.           but the disadvantage is that each user is going to be
  161.           creating duplicate files and using precious disk space.  A
  162.           good way to keep index files updated is by doing a _t_i_n -_U
  163.           that will update index files in the background while you are
  164.           reading news in the foreground. You can also update index
  165.           files via the system batcher cron with the -u option:
  166.                30 6 * * * /usr/local/bin/tin -u
  167.  
  168.           A slightly better method is to set _t_i_n setuid news and have
  169.           all index files created and updated in the news spool
  170.           directory (i.e. /_u_s_r/_s_p_o_o_l/_n_e_w_s/._i_n_d_e_x). This has the
  171.           advantage that there will only be one copy of the index
  172.           files on each machine on your network, but the disadvantage
  173.           is that you will have _t_i_n running setuid news.
  174.  
  175.           A better method is to install the _t_i_n_d index file updating
  176.           daemon and have it create and update index files for all
  177.           groups in your active file at regular intervals in the news
  178.           spool directory (i.e. /_u_s_r/_s_p_o_o_l/_n_e_w_s/._i_n_d_e_x). This has the
  179.           advantage that there will only be one copy of the index
  180.           files on each machine on your network and _t_i_n must not be
  181.           setuid news, but the disadvantage is that you will have to
  182.           have news permissions to install _t_i_n_d and root permissions
  183.           to install an entry in the cron batcher system to have _t_i_n_d
  184.           regularly update index files.
  185.  
  186.           The best method is to install the _t_i_n_d index file updating
  187.           daemon on your NNTP server and have it create and update
  188.           index files for all groups in your active file at regular
  189.           intervals in the news spool directory (i.e.
  190.           /_u_s_r/_s_p_o_o_l/_n_e_w_s/._i_n_d_e_x).  This has the advantage that there
  191.           will only be one copy of the index files on the NNTP server
  192.  
  193.  
  194.  
  195.      Page 3                                              March 9, 1994
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  203.  
  204.  
  205.  
  206.           for the whole of your network, but the disadvantage is that
  207.           you will have to install my NNTP server patches to allow _t_i_n
  208.           to retreive index file from your NNTP server and and you
  209.           must install an entry in the cron batcher system to have
  210.           _t_i_n_d regularly update index files (note that this is the
  211.           method we use on our network of 40-50 machines and have not
  212.           had any problems).
  213.  
  214.           Entering a group the first time tends to be slow because the
  215.           index file must be built from scratch unless the _t_i_n_d update
  216.           daemon is being used. To alleviate the slowness start _t_i_n to
  217.           create all index files for the groups you subscribe to with
  218.           _t_i_n -_u -_v and go for a coffee. Subsequent readings of a
  219.           group will cause incremental updating of the index file.
  220.  
  221.           If reading news remotely and locally updating index files
  222.           operation will be somewhat slower because the articles must
  223.           be retreived from the NNTP server.
  224.  
  225.      NNNNEEEEWWWWSSSS AAAADDDDMMMMIIIINNNNIIIISSSSTTTTRRRRAAAATTTTIIIIOOOONNNN
  226.           Maintaining Netnews on large networks of machines can be a
  227.           pretty time consuming job as I discovered when I was given
  228.           the job of maintaining our news system and news users.
  229.  
  230.           _T_i_n is a News User Agent and so most of the users were
  231.           always asking questions or doing things that could be
  232.           frowned upon by there departments.  To releive news admins
  233.           (and especially me) of this features have been added to make
  234.           life easier for news adminstrators.
  235.  
  236.           When a user starts _t_i_n it is possible to inform them of any
  237.           important changes/information concerning the news system by
  238.           displaying a message of the day (motd) file. The motd file
  239.           should be created in your news lib directory (i.e.
  240.           /_u_s_r/_l_i_b/_n_e_w_s/_m_o_t_d) and should have file permissions set to
  241.           0644. The motd file will only be displayed if its contents
  242.           is newer than the last time the user started _t_i_n. If reading
  243.           news via NNTP my XMOTD patch will have to have been applied
  244.           to your NNTP server.
  245.  
  246.           A user starting _t_i_n for the first time can be automatically
  247.           subscribed to a list of newsgroups that are deemed
  248.           appropriate by the news administrator. At our site the
  249.           subscriptions file has 125 groups (our active file contains
  250.           over 400 groups with many only being marginally interesting
  251.           to most people).  The subscriptions file should be created
  252.           in your news lib directory (i.e.
  253.           /_u_s_r/_l_i_b/_n_e_w_s/_s_u_b_s_c_r_i_p_t_i_o_n_s) and should have file
  254.           permissions set to 0644. If reading news via NNTP my LIST
  255.           SUBSCRIPTIONS patch will have to have been applied to your
  256.           NNTP server.
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                              March 9, 1994
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  269.  
  270.  
  271.  
  272.           If my NNTP XUSER patch has been applied to your NNTP server
  273.           you will be able to log the username and machine to your
  274.           NNTP logfile for usage statistics.
  275.  
  276.      SSSSCCCCRRRREEEEEEEENNNN FFFFOOOORRRRMMMMAAAATTTT
  277.           _T_i_n has five separate levels of operation: Group selection
  278.           level, Spooldir selection level, Group level, Thread level
  279.           and Article level.
  280.  
  281.           At the Group Selection level the title displays the number
  282.           of subscribed groups.  The newsgroups are displayed on the
  283.           left of the screen with the number of unread articles
  284.           displayed on the same line in the middle of the screen.
  285.                     <Selection Num> <Newsgroup> <Num of unread articles>
  286.                i.e.,
  287.                     1  alt.sources            10
  288.                     2  comp.sources.misc      3
  289.                     3  news.software.readers  12
  290.  
  291.           At the Group level the title contains the name of the group,
  292.           the number of conversation threads and total number of
  293.           articles i.e., alt.sources (7 23).  If the group has been
  294.           setup not to thread articles (i.e., alt.sources is in
  295.           $(_H_O_M_E)/._t_i_n/_u_n_t_h_r_e_a_d) the title will be alt.sources (U 23).
  296.           There are two possible display formats as shown below:
  297.                     <Selection Num> <Unread> <Responses> <Subject> <Author>
  298.                i.e.,
  299.                     1   +   3   Bnews sources?      iain@anl433.uucp
  300.                     2       1   This question has   ether@net
  301.                or
  302.                     <Selection Num> <Unread> <Responses> <Subject (longer)>
  303.                i.e.,
  304.                     1   +   3   Bnews sources?
  305.                     2       1   This question has a longer subject line
  306.  
  307.           At the Article level the page header has the following
  308.           format:
  309.                     <Date posted> <Newsgroup>    <Thread 1 of n>
  310.                     <Article Num> <Subject>      <Num of responses in thread>
  311.                     <Author>                     <Organization>
  312.  
  313.                     <Article body>
  314.                i.e.,
  315.                     24 Jul 15:20:03 GMT   alt.sources      Thread 1 of 2
  316.                     Article 452           Bnews sources?   3 responses
  317.                     iain@anl433.uucp                       Organization name
  318.  
  319.                     <Article boby>
  320.  
  321.      CCCCOOOOMMMMMMMMOOOONNNN MMMMOOOOVVVVIIIINNNNGGGG KKKKEEEEYYYYSSSS
  322.           This table shows the common keys/commands for moving at all
  323.           five levels within _t_i_n.
  324.  
  325.  
  326.  
  327.      Page 5                                              March 9, 1994
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  335.  
  336.  
  337.  
  338.                                           ansi/at386/vt100  Other Terminals
  339.                Beginning of list/article  HHHHoooommmmeeee              1111 (^^^^RRRR or gggg at article level)
  340.                End of list/article        EEEEnnnndddd               $$$$ (also GGGG at article level)
  341.                Page Up                    PPPPggggUUUUpppp              ^^^^UUUU or ^^^^BBBB or bbbb
  342.                Page Down                  PPPPggggDDDDnnnn              ^^^^DDDD or ^^^^FFFF or <<<<SSSSPPPPAAAACCCCEEEE>>>>
  343.                Line Up                    UUUUpppp aaaarrrrrrrroooowwww          kkkk (not at article level)
  344.                Line Down                  DDDDoooowwwwnnnn aaaarrrrrrrroooowwww        jjjj (not at article level)
  345.  
  346.      CCCCOOOOMMMMMMMMOOOONNNN EEEEDDDDIIIITTTTIIIINNNNGGGG CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
  347.           An emacs style editing package allows the easy editing of
  348.           input strings.  An history list allows the easy reuse of
  349.           previously entered strings.  The following commands are
  350.           available when editing a string:
  351.  
  352.           ^^^^AAAA,,,,^^^^EEEE     move to beginning or end of line, respectively.
  353.  
  354.           ^^^^FFFF,,,,^^^^BBBB     nondestructive move forward or back one location,
  355.                     respectively.
  356.  
  357.           ^^^^DDDD        delete the character currently under the cursor,
  358.                     or send EOF if no characters in the buffer.
  359.  
  360.           ^^^^HHHH,,,,<<<<DDDDEEEELLLL>>>>  delete character left of the cursor.
  361.  
  362.           ^^^^KKKK        delete from cursor to end of line.
  363.  
  364.           ^^^^PPPP,,,,^^^^NNNN     move through history, previous and next,
  365.                     respectively.
  366.  
  367.           ^^^^LLLL,,,,^^^^RRRR     redraw the current line.
  368.  
  369.           <<<<CCCCRRRR>>>>      places line on history list if nonblank, appends
  370.                     newline and returns to the caller.
  371.  
  372.           <<<<EEEESSSSCCCC>>>>     aborts the present editing operation.
  373.  
  374.      NNNNEEEEWWWWSSSSGGGGRRRROOOOUUUUPPPP SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
  375.           4444         Select group 4.
  376.  
  377.           ^^^^KKKK        Delete current group from $_H_O_M_E/._n_e_w_s_r_c file.
  378.  
  379.           ^^^^LLLL        Redraw page.
  380.  
  381.           ^^^^RRRR        Reset $_H_O_M_E/._n_e_w_s_r_c file.
  382.  
  383.           <<<<CCCCRRRR>>>>      Read current group.
  384.  
  385.           <<<<TTTTAAAABBBB>>>>     View next group with unread news. Will wrap around
  386.                     to the beginning of the group selection list
  387.                     looking for unread groups.
  388.  
  389.           BBBB         Mail a bug report or comment to the author.  This
  390.  
  391.  
  392.  
  393.      Page 6                                              March 9, 1994
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  401.  
  402.  
  403.  
  404.                     is the best way of getting bugs fixed and features
  405.                     added/changed.
  406.  
  407.           cccc         Mark current group as all read with confirmation
  408.                     and goto next group in group selection list.
  409.  
  410.           CCCC         Mark current group as all read and goto next
  411.                     unread group in group selection list.
  412.  
  413.           dddd         Toggle display to show just the groupname or the
  414.                     groupname and the groups description.
  415.  
  416.           gggg         Choose a new group by name.  The position of the
  417.                     group within the group list will also be asked
  418.                     for.  By entering '1' the new group will be the
  419.                     first group in the displayed list, by entering '8'
  420.                     the group will be the eighth group in the list
  421.                     etc.  By entering '$' the group will be the last
  422.                     group displayed.
  423.  
  424.           hhhh         Help screen of newsgroup selection commands.
  425.  
  426.           HHHH         Toggle the display of help mini menu at the bottom
  427.                     of the screen.
  428.  
  429.           IIII         Toggle inverse video.
  430.  
  431.           llll         List and allow selection of the available spool
  432.                     directories.  This feature requires a special
  433.                     library to be linked with _t_i_n to create _c_d_t_i_n
  434.                     which can then read news from an active news feed
  435.                     and also from multiple CD-ROMs.
  436.  
  437.           mmmm         Move the current group within the group selection
  438.                     list.  By entering '1' the group will become the
  439.                     first displayed group in the list, by entering '8'
  440.                     the eighth group in the list etc.  By entering '$'
  441.                     the group will be the last group displayed.
  442.  
  443.           MMMM         User configurable options menu (for more
  444.                     information see section Options Menu).
  445.  
  446.           qqqq         Quit _t_i_n.
  447.  
  448.           QQQQ         Quit _t_i_n.
  449.  
  450.           rrrr         Toggle display of all subscribed to groups and
  451.                     just the subscribed to groups containing unread
  452.                     articles. Command has no effect if groups were
  453.                     read from the command line when _t_i_n was started.
  454.  
  455.           ssss         Subscribe to current group.
  456.  
  457.  
  458.  
  459.      Page 7                                              March 9, 1994
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  467.  
  468.  
  469.  
  470.           SSSS         Subscribe to groups matching user specified
  471.                     pattern.
  472.  
  473.           uuuu         Unsubscribe to current group.
  474.  
  475.           UUUU         Unsubscribe to groups matching user specified
  476.                     pattern.
  477.  
  478.           vvvv         Print _t_i_n version information.
  479.  
  480.           wwww         Post an article to current group.
  481.  
  482.           WWWW         List articles posted by user.  The date posted,
  483.                     the newsgroup and the subject are listed.
  484.  
  485.           yyyy         The first time this command is called it will yank
  486.                     in all groups from $_L_I_B_D_I_R/_a_c_t_i_v_e that are not in
  487.                     $_H_O_M_E/._n_e_w_s_r_c.  After any groups have been
  488.                     subscribed/unsubscribed to, this command if
  489.                     pressed again will reread $_H_O_M_E/._n_e_w_s_r_c and
  490.                     display only the subscribed groups.
  491.  
  492.           YYYY         Reread the active file to see if any new news has
  493.                     arrived since starting _t_i_n.
  494.  
  495.           zzzz         Mark all articles in the current group as unread.
  496.  
  497.           ZZZZ         Undelete previously deleted group by ^K command
  498.                     from $_H_O_M_E/._n_e_w_s_r_c.
  499.  
  500.           ////         Group forward search.
  501.  
  502.           ????         Group backward search.
  503.  
  504.      SSSSPPPPOOOOOOOOLLLL DDDDIIIIRRRREEEECCCCTTTTOOOORRRRYYYY SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
  505.           4444         Select spool directory 4.
  506.  
  507.           ^^^^LLLL        Redraw page.
  508.  
  509.           <<<<CCCCRRRR>>>>      Read news from selected spool directory.
  510.  
  511.           BBBB         Mail a bug report or comment to the author.  This
  512.                     is the best way of getting bugs fixed and features
  513.                     added/changed.
  514.  
  515.           hhhh         Help screen of spool directory selection commands.
  516.  
  517.           HHHH         Toggle the display of help mini menu at the bottom
  518.                     of the screen.
  519.  
  520.           IIII         Toggle inverse video.
  521.  
  522.  
  523.  
  524.  
  525.      Page 8                                              March 9, 1994
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  533.  
  534.  
  535.  
  536.           qqqq         Return to previous level.
  537.  
  538.           QQQQ         Quit _t_i_n.
  539.  
  540.           vvvv         Print _t_i_n version information.
  541.  
  542.      GGGGRRRROOOOUUUUPPPP IIIINNNNDDDDEEEEXXXX CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
  543.           4444         Select article 4.
  544.  
  545.           ^^^^KKKK        Kill current article (for more information read
  546.                     section Kill Article Menu).
  547.  
  548.           ^^^^LLLL        Redraw page.
  549.  
  550.           <<<<CCCCRRRR>>>>      Read current article.
  551.  
  552.           <<<<TTTTAAAABBBB>>>>     View next unread article or group.
  553.  
  554.           aaaa         Author forward search.
  555.  
  556.           AAAA         Author backward search.
  557.  
  558.           cccc         Mark all articles as read with confirmation.
  559.  
  560.           CCCC         Mark all articles as read and goto next group with
  561.                     unread news.
  562.  
  563.           dddd         Toggle display to show just the subject or the
  564.                     subject and author.
  565.  
  566.           gggg         Choose a new group by name.
  567.  
  568.           hhhh         Help screen of group index commands.
  569.  
  570.           HHHH         Toggle the display of help mini menu at the bottom
  571.                     of the screen.
  572.  
  573.           IIII         Toggle inverse video.
  574.  
  575.           KKKK         Mark article/thread as read and advance to next
  576.                     unread article/thread.
  577.  
  578.           llll         List the author of each response in current thread
  579.                     and enter thread selection level.
  580.  
  581.           mmmm         Mail current article / thread / auto selected
  582.                     (hot) articles / articles matching pattern /
  583.                     tagged articles to someone.
  584.  
  585.           MMMM         User configurable options menu (for more
  586.                     information see section Options Menu).
  587.  
  588.  
  589.  
  590.  
  591.      Page 9                                              March 9, 1994
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  599.  
  600.  
  601.  
  602.           nnnn         Go to next group.
  603.  
  604.           NNNN         Go to next unread article.
  605.  
  606.           oooo         Output current article / thread / auto selected
  607.                     (hot) articles / articles matching pattern /
  608.                     tagged articles to printer.
  609.  
  610.           pppp         Go to previous group.
  611.  
  612.           PPPP         Go to previous unread article.
  613.  
  614.           qqqq         Return to previous level.
  615.  
  616.           QQQQ         Quit _t_i_n.
  617.  
  618.           ssss         Save current article / thread / auto selected
  619.                     (hot) articles / articles matching pattern /
  620.                     tagged articles to file / files / mailbox.  To
  621.                     save to a mailbox enter '=' or '=mailbox' when
  622.                     asked for filename to save to.  To save in
  623.                     <newsgroup name>/<filename> format enter
  624.                     '+filename'.  Environment variables are allowed
  625.                     within a filename (i.e. $_S_O_U_R_C_E_S/_d_i_r/_f_i_l_e_n_a_m_e).
  626.  
  627.           tttt         Tag current article / thread for mailing ('m') /
  628.                     piping ('|') / printing ('o') / saving ('s') /
  629.                     crossposting ('x').
  630.  
  631.           uuuu         Toggle display to show all articles as unthreaded
  632.                     or threaded.
  633.  
  634.           UUUU         Untag all articles that were tagged.
  635.  
  636.           vvvv         Print _t_i_n version information.
  637.  
  638.           wwww         Post an article to current group.
  639.  
  640.           WWWW         List articles posted by user.  The date posted,
  641.                     the newsgroup and the subject are listed.
  642.  
  643.           xxxx         Crosspost already posted current article / thread
  644.                     / auto selected (hot) articles / articles matching
  645.                     pattern / tagged articles to another newsgroup(s).
  646.                     Useful for reposting from global to local
  647.                     newsgroups.
  648.  
  649.           XXXX         Mark all unread articles that have not been
  650.                     selected as read, redo screen to reflect changes
  651.                     and put index at the first thread to begin
  652.                     reading. Pressing 'X' again will toggle back to
  653.                     the way it was before. See '~' command for
  654.  
  655.  
  656.  
  657.      Page 10                                             March 9, 1994
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  665.  
  666.  
  667.  
  668.                     clearing the toggle effect.
  669.  
  670.           zzzz         Mark current article as unread.
  671.  
  672.           ZZZZ         Mark current thread as unread.
  673.  
  674.           ////         Search forward for specified subject.
  675.  
  676.           ????         Search backward for specified subject.
  677.  
  678.           ----         Show last message.
  679.  
  680.           ||||         Pipe current article / thread / auto selected
  681.                     (hot) articles / articles matching pattern /
  682.                     tagged articles into command.
  683.  
  684.           ****         Select current thread for later processing.
  685.  
  686.           TTTToooogggggggglllleeee sssseeeelllleeeeccccttttiiiioooonnnn ooooffff ccccuuuurrrrrrrreeeennnntttt tttthhhhrrrreeeeaaaadddd.... IIIIffff aaaatttt lllleeeeaaaasssstttt oooonnnneeee uuuunnnnrrrreeeeaaaadddd aaaarrrrtttt,,,,
  687.                     but not all unread arts, in thread is selected,
  688.                     then all unread arts become selected.
  689.  
  690.           @@@@         Reverse all selections on all articles.
  691.  
  692.           ~~~~         Undo all selections on all articles. It clears the
  693.                     toggle effect of 'X' command. Thus after first
  694.                     doing a 'X', one can then do '~' to reset
  695.                     articles. Thus, one can iteratively whittle down
  696.                     uninteresting threads.
  697.  
  698.           ++++         Perform auto-selection on current group.
  699.  
  700.           ;;;;         For each thread in current group, if it at least
  701.                     one unread art is selected, all unread arts become
  702.                     selected. This is useful for auto-selection on
  703.                     author where reader wants to see entire thread.
  704.  
  705.           ====         Prompts for a pattern with which to match on. All
  706.                     threads whose subjects match the pattern will be
  707.                     selected. A pattern of "*" will match all
  708.                     subjects. Entering just <CR> will cause the
  709.                     previous pattern to be used.
  710.  
  711.      TTTTHHHHRRRREEEEAAAADDDD LLLLIIIISSSSTTTTIIIINNNNGGGG CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
  712.           4444         Select article 4 within thread.
  713.  
  714.           ^^^^LLLL        Redraw page.
  715.  
  716.           <<<<CCCCRRRR>>>>      Read current article within thread.
  717.  
  718.           <<<<TTTTAAAABBBB>>>>     View next unread article within thread.
  719.  
  720.  
  721.  
  722.  
  723.      Page 11                                             March 9, 1994
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  731.  
  732.  
  733.  
  734.           BBBB         Mail a bug report or comment to the author.  This
  735.                     is the best way of getting bugs fixed and features
  736.                     added/changed.
  737.  
  738.           cccc         Mark thread as read after confirmation and return
  739.                     to previous level.
  740.  
  741.           dddd         Toggle display to show just the subject or the
  742.                     subject and author.
  743.  
  744.           hhhh         Help screen of thread listing commands.
  745.  
  746.           HHHH         Toggle the display of help mini menu at the bottom
  747.                     of the screen.
  748.  
  749.           IIII         Toggle inverse video.
  750.  
  751.           KKKK         Mark thread as read and return to previous level.
  752.  
  753.           qqqq         Return to previous level.
  754.  
  755.           QQQQ         Quit _t_i_n.
  756.  
  757.           rrrr         Toggle display to show all articles or only unread
  758.                     articles.
  759.  
  760.           BBBB         Mail a bug report or comment to the author.  This
  761.                     is the best way of getting bugs fixed and features
  762.                     added/changed.
  763.  
  764.           tttt         Tag current article for mailing ('m') / piping
  765.                     ('|') / printing ('o') / saving ('s') /
  766.                     crossposting ('x').
  767.  
  768.           TTTT         Return to group index level.
  769.  
  770.           vvvv         Print _t_i_n version information.
  771.  
  772.           zzzz         Mark current article in thread as unread.
  773.  
  774.           ZZZZ         Mark all articles in thread as unread.
  775.  
  776.      AAAARRRRTTTTIIIICCCCLLLLEEEE VVVVIIIIEEEEWWWWEEEERRRR CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
  777.           0000         Read the base article in this thread.
  778.  
  779.           4444         Read response 4 in this thread.
  780.  
  781.           ^^^^HHHH        Show all of the articles mail header.
  782.  
  783.           ^^^^KKKK        Kill current article (for more information read
  784.                     section Kill Article Menu).
  785.  
  786.  
  787.  
  788.  
  789.      Page 12                                             March 9, 1994
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  797.  
  798.  
  799.  
  800.           ^^^^LLLL        Redraw page.
  801.  
  802.           <<<<CCCCRRRR>>>>      Goto next base article.
  803.  
  804.           <<<<TTTTAAAABBBB>>>>     Goto next unread article.
  805.  
  806.           aaaa         Author forward search.
  807.  
  808.           AAAA         Author backward search.
  809.  
  810.           cccc         Mark all articles as read with confirmation and
  811.                     return to group selection level.
  812.  
  813.           CCCC         Mark current group as all read and goto next
  814.                     unread group in group selection list.
  815.  
  816.           dddd         Toggle rot-13 decoding for this article.
  817.  
  818.           DDDD         Delete current article.  It must have been posted
  819.                     by the same user.  The cancel message can be seen
  820.                     in the newsgroup 'control'.
  821.  
  822.           ffff         Post a followup to the current article with a copy
  823.                     of the article included.
  824.  
  825.           FFFF         Post a followup to the current article.
  826.  
  827.           hhhh         Help screen of article page commands.
  828.  
  829.           HHHH         Toggle the display of help mini menu at the bottom
  830.                     of the screen.
  831.  
  832.           IIII         Toggle inverse video.
  833.  
  834.           kkkk         Mark article as read and advance to next unread
  835.                     article.
  836.  
  837.           KKKK         Mark thread as read and advance to next unread
  838.                     thread.
  839.  
  840.           mmmm         Mail current article / thread / auto selected
  841.                     (hot) articles / articles matching pattern /
  842.                     tagged articles to someone.
  843.  
  844.           MMMM         User configurable options menu (for more
  845.                     information see section Options Menu).
  846.  
  847.           nnnn         Go to the next article.
  848.  
  849.           NNNN         Go to the next unread article.
  850.  
  851.           oooo         Output current article / thread / auto selected
  852.  
  853.  
  854.  
  855.      Page 13                                             March 9, 1994
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  863.  
  864.  
  865.  
  866.                     (hot) articles / articles matching pattern /
  867.                     tagged articles to printer.
  868.  
  869.           oooo         Output article/thread/tagged articles to printer.
  870.  
  871.           pppp         Go to the previous article.
  872.  
  873.           PPPP         Go to the previous unread article.
  874.  
  875.           qqqq         Return to previous level.
  876.  
  877.           QQQQ         Quit _t_i_n.
  878.  
  879.           rrrr         Reply through mail to the author of the current
  880.                     article with a copy of the article included.
  881.  
  882.           RRRR         Reply through mail to the author of the current
  883.                     article.
  884.  
  885.           ssss         Save current article / thread / auto selected
  886.                     (hot) articles / articles matching pattern /
  887.                     tagged articles to file / files / mailbox.  To
  888.                     save to a mailbox enter '=' or '=mailbox' when
  889.                     asked for filename to save to.  To save in
  890.                     <newsgroup name>/<filename> format enter
  891.                     '+filename'.  Environment variables are allowed
  892.                     within a filename (i.e. $_S_O_U_R_C_E_S/_d_i_r/_f_i_l_e_n_a_m_e).
  893.  
  894.           tttt         Return to group selection level.
  895.  
  896.           TTTT         Tag current article for mailing ('m') / piping
  897.                     ('|') / printing ('o') / saving ('s') /
  898.                     crossposting ('x').
  899.  
  900.           vvvv         Print _t_i_n version information.
  901.  
  902.           wwww         Post an article to current group.
  903.  
  904.           WWWW         List articles posted by user.  The date posted,
  905.                     the newsgroup and the subject are listed.
  906.  
  907.           xxxx         Crosspost already posted current article / thread
  908.                     / auto selected (hot) articles / articles matching
  909.                     pattern / tagged articles to another newsgroup(s).
  910.                     Useful for reposting from global to local
  911.                     newsgroups.
  912.  
  913.           zzzz         Mark article as unread.
  914.  
  915.           ////         Article forward search.
  916.  
  917.           ????         Article backward search
  918.  
  919.  
  920.  
  921.      Page 14                                             March 9, 1994
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  929.  
  930.  
  931.  
  932.           ||||         Pipe current article / thread / auto selected
  933.                     (hot) articles / articles matching pattern /
  934.                     tagged articles into command.
  935.  
  936.           <<<<         Goto the first article in the current thread.
  937.  
  938.           >>>>         Goto the last article in the current thread.
  939.  
  940.           ****         Select current thread for later processing.
  941.  
  942.           TTTToooogggggggglllleeee sssseeeelllleeeeccccttttiiiioooonnnn ooooffff ccccuuuurrrrrrrreeeennnntttt aaaarrrrttttiiiicccclllleeee....
  943.  
  944.           @@@@         Reverse article selections.
  945.  
  946.           ~~~~         Undo all selections on current thread.
  947.  
  948.      GGGGLLLLOOOOBBBBAAAALLLL OOOOPPPPTTTTIIIIOOOONNNNSSSS MMMMEEEENNNNUUUU
  949.           This menu is accessed by pressing 'M' at all levels.  It
  950.           allows the user to customize the behaviour of _t_i_n. The
  951.           options are saved to the file $_H_O_M_E/._t_i_n/_t_i_n_r_c.  Use <SPACE>
  952.           to toggle the required option and <CR> to set.
  953.  
  954.           AAAAuuuuttttoooo ssssaaaavvvveeee
  955.               Automatically save articles/threads by ``Archive-name:''
  956.               line in article header and post process them if process
  957.               type is not set to None.
  958.  
  959.           EEEEddddiiiittttoooorrrr ooooffffffffsssseeeetttt
  960.               Set ON if the editor used for posting, follow-ups and
  961.               bug reports has the capability of starting and
  962.               positioning the cursor at a specified line within a
  963.               file.
  964.  
  965.           MMMMaaaarrrrkkkk ssssaaaavvvveeeedddd rrrreeeeaaaadddd
  966.               Allows saved articles/threads to be automatically marked
  967.               as read.
  968.  
  969.           CCCCoooonnnnffffiiiirrrrmmmm CCCCoooommmmmmmmaaaannnndddd
  970.               Allows certain commands (i.e. 'c' catchup) that require
  971.               user confirmation to be executed immediately if set OFF.
  972.  
  973.           DDDDrrrraaaawwww aaaarrrrrrrroooowwww
  974.               Allows groups/articles to be selected by an arrow '->'
  975.               if set ON or by an highlighted bar if set OFF.
  976.  
  977.           PPPPrrrriiiinnnntttt hhhheeeeaaaaddddeeeerrrr
  978.               This allows the complete mail header or only the
  979.               ``Subject:'' and ``From:'' fields to be output when
  980.               printing articles.
  981.  
  982.           GGGGoooottttoooo 1111sssstttt uuuunnnnrrrreeeeaaaadddd
  983.               This allows the cursor to be placed at the first / last
  984.  
  985.  
  986.  
  987.      Page 15                                             March 9, 1994
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  995.  
  996.  
  997.  
  998.               unread article upon entering a newsgroup with unread
  999.               news.
  1000.  
  1001.           SSSSccccrrrroooollllllll ffffuuuullllllll ppppaaaaggggeeee
  1002.               If set ON scrolling of groups/articles will be a full
  1003.               page at a time, otherwise half a page at a time.
  1004.  
  1005.           CCCCaaaattttcccchhhhuuuupppp oooonnnn qqqquuuuiiiitttt
  1006.               If set ON the user is asked when quitting if all groups
  1007.               read during the current session should be marked read.
  1008.  
  1009.           TTTThhhhrrrreeeeaaaadddd aaaarrrrttttiiiicccclllleeeessss
  1010.               If set ON articles will be threaded in all groups
  1011.               (default), otherwise articles will be shown unthreaded.
  1012.               Threading/unthreading is possible on a per group basis
  1013.               by setting the group attribute variable 'thread_arts' to
  1014.               ON/OFF in the file $_H_O_M_E/._t_i_n/_a_t_t_r_i_b_u_t_e_s.
  1015.  
  1016.           SSSShhhhoooowwww oooonnnnllllyyyy uuuunnnnrrrreeeeaaaadddd
  1017.               If set ON show only new/unread articles, otherwise show
  1018.               all articles.
  1019.  
  1020.           SSSShhhhoooowwww ddddeeeessssccccrrrriiiippppttttiiiioooonnnn
  1021.               If set ON show a short descriptive text for each
  1022.               displayed newsgroup.  The text used is taken from the
  1023.               $_L_I_B_D_I_R/_n_e_w_s_g_r_o_u_p_s file.
  1024.  
  1025.           SSSShhhhoooowwww AAAAuuuutttthhhhoooorrrr
  1026.               If set 'None' only the ``Subject:'' line will be
  1027.               displayed.  If set 'Addr' ``Subject:'' line & the
  1028.               address part of the ``From:'' line are displayed.  If
  1029.               set 'Name' ``Subject:'' line & the authors full name
  1030.               part of the ``From:'' line are displayed.  If set 'Both'
  1031.               ``Subject:'' line & all of the ``From:'' line are
  1032.               displayed.
  1033.  
  1034.           PPPPrrrroooocccceeeessssssss ttttyyyyppppeeee
  1035.               This specifies the default type of post processing to
  1036.               perform on saved articles.  The following types of
  1037.               processing are allowed:
  1038.                   -none.
  1039.                   -unpacking of multi-part shell archives.
  1040.                   -unpacking of multi-part uuencoded files.
  1041.                   -unpacking of multi-part uuencoded files, which
  1042.                    produce a *.zoo archive whose contents is listed.
  1043.                   -unpacking of multi-part uuencoded files, which
  1044.                    produce a *.zoo archive whose contents is
  1045.                    extracted.
  1046.                   -unpacking of multi-part uuencoded files, which
  1047.                    produce a *.zip archive whose contents is listed.
  1048.                   -unpacking of multi-part uuencoded files, which
  1049.                    produce a *.zip archive whose contents is
  1050.  
  1051.  
  1052.  
  1053.      Page 16                                             March 9, 1994
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  1061.  
  1062.  
  1063.  
  1064.                    extracted.
  1065.                   -unpacking of multi-part uuencoded files, which
  1066.                    produce a *.lha archive whose contents is listed
  1067.                    (AmigaDOS version only).
  1068.                   -unpacking of multi-part uuencoded files, which
  1069.                    produce a *.lha archive whose contents is extracted
  1070.                    (AmigaDOS version only).
  1071.  
  1072.           SSSSoooorrrrtttt aaaarrrrttttiiiicccclllleeeessss bbbbyyyy
  1073.               This specifies how articles should be sorted.  The
  1074.               following sort types are allowed:
  1075.                   -don't sort articles (default).
  1076.                   -sort articles by ``Subject:'' field (ascending &
  1077.                    descending).
  1078.                   -sort articles by ``From:'' field (ascending &
  1079.                    descending).
  1080.                   -sort articles by ``Date:'' field (ascending &
  1081.                    descending).
  1082.  
  1083.           SSSSaaaavvvveeee ddddiiiirrrreeeeccccttttoooorrrryyyy
  1084.               The directory where articles/threads are to be saved.
  1085.               Default is $_H_O_M_E/_N_e_w_s.
  1086.  
  1087.           MMMMaaaaiiiillll ddddiiiirrrreeeeccccttttoooorrrryyyy
  1088.               The directory where articles/threads are to be saved in
  1089.               mailbox format.  This feature is mainly for use with the
  1090.               Elm mail program.  It allows the user to save
  1091.               articles/threads/groups simply by giving '=' as the
  1092.               filename to save to.
  1093.  
  1094.           PPPPrrrriiiinnnntttteeeerrrr
  1095.               The printer program with options that is to be used to
  1096.               print articles.  Default is lpr for BSD machines and lp
  1097.               for SysV machines.
  1098.  
  1099.      TTTTIIIINNNNRRRRCCCC CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAABBBBLLLLEEEE VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS
  1100.           The following variables are user configurable by editing
  1101.           $_H_O_M_E/._t_i_n/_t_i_n_r_c directly. It is hoped to eventually provide
  1102.           a menu to allow the setting of the most common variables.
  1103.  
  1104.           bbbbaaaattttcccchhhh____ssssaaaavvvveeee
  1105.               If set ON articles/threads will be saved in batch mode
  1106.               when save -S or mail -M is specified on the command
  1107.               line. Default is OFF.
  1108.  
  1109.           bbbbeeeeggggiiiinnnnnnnneeeerrrr____lllleeeevvvveeeellll
  1110.               If set ON a mini menu of the most useful commands will
  1111.               be displayed at the bottom of the screen for each level.
  1112.               Default is ON.
  1113.  
  1114.           ddddiiiissssppppllllaaaayyyy____rrrreeeeaaaaddddiiiinnnngggg____pppprrrroooommmmpppptttt
  1115.               The prompt ``Reading...'' will be displayed when reading
  1116.  
  1117.  
  1118.  
  1119.      Page 17                                             March 9, 1994
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  1127.  
  1128.  
  1129.  
  1130.               an article from a NNTP server to provide feedback to the
  1131.               user. Default is ON.
  1132.  
  1133.           ffffoooorrrrcccceeee____ssssccccrrrreeeeeeeennnn____rrrreeeeddddrrrraaaawwww
  1134.               Specifies whether a screen redraw should always be done
  1135.               after certain external commands. Default is OFF.
  1136.  
  1137.           ggggrrrroooouuuuppppnnnnaaaammmmeeee____mmmmaaaaxxxx____lllleeeennnnggggtttthhhh
  1138.               Maximum length of the names of newsgroups to be
  1139.               displayed so that more of the newgroup description can
  1140.               be displayed. Default is 132.
  1141.  
  1142.           ddddeeeeffffaaaauuuulllltttt____ssssiiiiggggffffiiiilllleeee
  1143.               The path that specifies the signature file to use when
  1144.               posting, following upto or replying to an article. If
  1145.               the path is a directory then the signature will be
  1146.               randomly generated from files that are in the specified
  1147.               directory.  Default is $_H_O_M_E/._S_i_g.
  1148.  
  1149.           eeeeddddiiiittttoooorrrr____ffffoooorrrrmmmmaaaatttt
  1150.               The format string used to create the editor start
  1151.               command with parameters.  Default is '%E +%N %F' (i.e.,
  1152.               /bin/vi +7 .article).
  1153.  
  1154.           hhhhooootttt____aaaarrrrtttt____mmmmaaaarrrrkkkk
  1155.               The character used to show that an article/thread is
  1156.               auto-selected (hot). Default is '*'.
  1157.  
  1158.           qqqquuuuooootttteeee____cccchhhhaaaarrrrssss
  1159.               The character used in quoting included text to article
  1160.               followups and mail replys. The '_' character represents
  1161.               a blank character and is replaced with ' ' when read.
  1162.               Default is ':_'.
  1163.  
  1164.           rrrreeeerrrreeeeaaaadddd____aaaaccccttttiiiivvvveeee____ffffiiiilllleeee____sssseeeeccccssss
  1165.               The news active file is reread at regular intervals to
  1166.               show if any new news has arrived. Default is 300
  1167.               seconds.
  1168.  
  1169.           rrrreeeettttuuuurrrrnnnn____aaaarrrrtttt____mmmmaaaarrrrkkkk
  1170.               The character used to show that an article will return.
  1171.               Default is '-'.
  1172.  
  1173.           ssssaaaavvvveeee____ttttoooo____mmmmmmmmddddffff____mmmmaaaaiiiillllbbbbooooxxxx
  1174.               Allows articles to be saved to a MMDF style mailbox
  1175.               instead of mbox format.  Default is OFF unless reading
  1176.               news on SCO Unix which uses MMDF by default.
  1177.  
  1178.           sssshhhhoooowwww____llllaaaasssstttt____lllliiiinnnneeee____pppprrrreeeevvvv____ppppaaaaggggeeee
  1179.               The last line of the previous page will be displayed as
  1180.               the first line of next page. Default is OFF.
  1181.  
  1182.  
  1183.  
  1184.  
  1185.      Page 18                                             March 9, 1994
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  1193.  
  1194.  
  1195.  
  1196.           sssslllloooowwww____ssssppppeeeeeeeedddd____tttteeeerrrrmmmmiiiinnnnaaaallll
  1197.               Strips the blanks from the end of each line therefore
  1198.               speeding up the display when reading on a slow terminal
  1199.               or via modem. Default is OFF.
  1200.  
  1201.           ttttaaaabbbb____aaaafffftttteeeerrrr____XXXX____sssseeeelllleeeeccccttttiiiioooonnnn
  1202.               If enabled will automatically goto the first unread
  1203.               article after having selected all hot articles and
  1204.               threads with the 'X' command at group index level.
  1205.               Default is OFF.
  1206.  
  1207.           ttttaaaabbbb____ggggoooottttoooo____nnnneeeexxxxtttt____uuuunnnnrrrreeeeaaaadddd
  1208.               If enabled pressing TAB at the article viewer level will
  1209.               goto the next unread article immediately instead of
  1210.               first paging through the current one. Default is ON.
  1211.  
  1212.           uuuunnnnrrrreeeeaaaadddd____aaaarrrrtttt____mmmmaaaarrrrkkkk
  1213.               The character used to show that an article has not been
  1214.               read. Default is '+'.
  1215.  
  1216.           uuuusssseeee____bbbbuuuuiiiillllttttiiiinnnn____iiiinnnneeeewwwwssss
  1217.               Allows the builtin NNTP inews to be enabled/disabled.
  1218.               Default is ON (enabled).
  1219.  
  1220.           uuuusssseeee____kkkkeeeeyyyyppppaaaadddd
  1221.               Allows the scroll keys on the keypad to be
  1222.               enabled/disabled on supported terminals. Default is OFF.
  1223.  
  1224.      GGGGRRRROOOOUUUUPPPP AAAATTTTTTTTRRRRIIIIBBBBUUUUTTTTEEEESSSS
  1225.           _T_i_n allows certain attributes to be set on a per group
  1226.           basis. These group attributes are read from the file
  1227.           $_H_O_M_E/._t_i_n/_a_t_t_r_i_b_u_t_e_s.  A later version will provide a menu
  1228.           interface to set all the attributes. At present you will
  1229.           have to edit the file with your editor :-(. The following
  1230.           group attributes are available:
  1231.  
  1232.                newsgroup=alt.sources
  1233.                maildir=/usr/iain/Mail/sources
  1234.                savedir=/usr/iain/News/alt.sources
  1235.                sigfile=/usr/iain/.funny_sig
  1236.                organization=Wacky Bits Inc.
  1237.                followup_to=alt.sources.d
  1238.                printer=/usr/local/bin/a2ps -nn | /bin/lpr
  1239.                auto_save=ON
  1240.                batch_save=OFF
  1241.                delete_tmp_files=ON
  1242.                show_only_unread=OFF
  1243.                thread_arts=ON
  1244.                show_author=1
  1245.                sort_art_type=5
  1246.                post_proc_type=1
  1247.  
  1248.  
  1249.  
  1250.  
  1251.      Page 19                                             March 9, 1994
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  1259.  
  1260.  
  1261.  
  1262.           Note that the ''newsgroup=<groupname>'' line has to be
  1263.           specified before the attributes are specified for that
  1264.           group.
  1265.  
  1266.           All attributes are set to a reasonable default so you only
  1267.           have to specify the attribute that you want to change (i.e.,
  1268.           savedir).
  1269.  
  1270.           All toggle attributes are set by specifying ON/OFF.
  1271.  
  1272.           The show_author attribute is specified by a number from the
  1273.           following range: 0=none, 1=username, 2=network address,
  1274.           3=both.
  1275.  
  1276.           The sort_art_type attribute is specified by a number from
  1277.           the following range: 0=none, 1=subject descending, 2=subject
  1278.           ascending, 3=from descending, 4=from ascending, 5=date
  1279.           descending, 6=date ascending.
  1280.  
  1281.           The post_proc_type attribute is specified by a number from
  1282.           the following range: 0=none, 1=unshar, 2=uudecode,
  1283.           3=uudecode & list zoo archive, 4=uudecode & extract zoo
  1284.           archive, 5=uudecode & list zip archive, 6=uudecode & extract
  1285.           zip archive. (note: if running on AmigaDOS the zoo options
  1286.           are replaced by there corresponding lha archiver options).
  1287.  
  1288.      AAAAUUUUTTTTOOOOMMMMAAAATTTTIIIICCCC KKKKIIIILLLLLLLL AAAANNNNDDDD SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN
  1289.           When there is a subject or an author which you are either
  1290.           very interested in, or find completely uninteresting, you
  1291.           can easily instruct _t_i_n to _a_u_t_o-_s_e_l_e_c_t or _a_u_t_o-_k_i_l_l articles
  1292.           with specific subjects or from specific authors.  These
  1293.           instructions are stored in a _k_i_l_l _f_i_l_e.
  1294.  
  1295.           This menu is accessed by pressing '^K' at the group and page
  1296.           levels.  It allows the user to kill or select an article
  1297.           that matches the current ``Subject:'' line, ``From:'' line
  1298.           or a string entered by the user. The user entered string can
  1299.           be applied to the ``Subject:'' or ``From:'' lines of an
  1300.           article.  The kill description can be limited to the current
  1301.           newsgroup or it can apply to all newsgroups. Once entered
  1302.           the user can abort the command and not save the kill
  1303.           description, edit the kill file or save the kill
  1304.           description.
  1305.  
  1306.           On starting _t_i_n the users killfile $_H_O_M_E/._t_i_n/_k_i_l_l is read
  1307.           and on entering a newsgroup any kill or select descriptions
  1308.           are applied.
  1309.  
  1310.           Articles that match a kill description are marked killed and
  1311.           are not displayed. Articles that match an auto-select
  1312.           description are marked with a ''*'' when displayed.
  1313.  
  1314.  
  1315.  
  1316.  
  1317.      Page 20                                             March 9, 1994
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  1325.  
  1326.  
  1327.  
  1328.      PPPPOOOOSSSSTTTTIIIINNNNGGGG AAAARRRRTTTTIIIICCCCLLLLEEEESSSS
  1329.           _T_i_n allows posting of articles, follow-up to already posted
  1330.           articles and replying direct through mail to the author of
  1331.           an article.
  1332.  
  1333.           Use the 'w' command to post an article to a newsgroup.
  1334.           After entering the post subject the default editor (i.e. vi)
  1335.           or the editor specified by the $VISUAL environment variable
  1336.           will be started and the article can be entered.  To
  1337.           crosspost articles simply add a comma and the name of the
  1338.           newsgroup(s) to the end of the ``Newsgroups:'' line at the
  1339.           beginning of the article.  After saving and exiting the
  1340.           editor you are asked if you wish to a)bort posting the
  1341.           article, e)dit the article again or p)ost the article to the
  1342.           specified newsgroup(s).
  1343.  
  1344.           Use the 'W' command to display a history of the articles you
  1345.           have posted.  The date the article was posted, which
  1346.           newsgroups the article was posted to and the articles
  1347.           subject line are displayed.
  1348.  
  1349.           Use the 'f' / 'F' command to post a follow-up article to an
  1350.           already posted article.  The 'f' command will copy the text
  1351.           of the original article into the editor.  The editing
  1352.           procedure is the same as when posting an article with the
  1353.           'w' command.
  1354.  
  1355.           Use the 'r' / 'R' command to reply direct through mail to
  1356.           the author of an already posted article.  The 'r' command
  1357.           will copy the text of the original article into the editor.
  1358.           The editing procedure is the same as when posting an article
  1359.           with the 'w' command.  After saving and exiting the editor
  1360.           you are asked if you wish to a)bort sending the article,
  1361.           e)dit the article again or s)end the article to the author.
  1362.  
  1363.      CCCCUUUUSSSSTTTTOOOOMMMMIIIIZZZZIIIINNNNGGGG TTTTHHHHEEEE AAAARRRRTTTTIIIICCCCLLLLEEEE QQQQUUUUOOOOTTTTEEEE SSSSTTTTRRRRIIIINNNNGGGG
  1364.           When posting a followup to an article or replying direct to
  1365.           the author of an article via email the text of the article
  1366.           can be quoted. The beginning of the quoted text can contain
  1367.           information about the quoted article (i.e., Name and the
  1368.           Message Id of the article). To allow for different
  1369.           situations certain information from the article can be used
  1370.           in the quoted string. The following variables are expanded
  1371.           if found in the tinrc variables 'mail_quote_format=' or
  1372.           'news_quote_format=':
  1373.                %%%%AAAA  Address (Email)
  1374.                %%%%DDDD  Date
  1375.                %%%%FFFF  Full address (%N (%A))
  1376.                %%%%GGGG  Groupname
  1377.                %%%%MMMM  Message Id
  1378.                %%%%NNNN  Name of user
  1379.           i.e.,
  1380.  
  1381.  
  1382.  
  1383.      Page 21                                             March 9, 1994
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  1391.  
  1392.  
  1393.  
  1394.                mail_quote_format=On %D in %G you wrote:
  1395.                news_quote_format=In %M, %F wrote:
  1396.           would expand when used to:
  1397.                On 21 Jul 1992 09:45:51 -0400 in alt.sources you wrote:
  1398.                In <abcINN123@anl433.uucp>, Iain Lea (iain@erlm.siemens.de) wrote:
  1399.  
  1400.      MMMMAAAAIIIILLLLIIIINNNNGGGG PPPPIIIIPPPPIIIINNNNGGGG PPPPRRRRIIIINNNNTTTTIIIINNNNGGGG RRRREEEEPPPPOOOOSSSSTTTTIIIINNNNGGGG AAAANNNNDDDD SSSSAAAAVVVVIIIINNNNGGGG AAAARRRRTTTTIIIICCCCLLLLEEEESSSS
  1401.           The command interface to mail ('m'), pipe ('|'), print
  1402.           ('o'), crosspost ('x') and save ('s') articles is the same
  1403.           for ease of use.
  1404.  
  1405.           The initial command will ask you to select which a)rticle,
  1406.           t)hread, h)ot (auto selected) r)egex pattern, t)agged
  1407.           articles you wish to mail, pipe etc.
  1408.  
  1409.           Tagged articles must have already been tagged with the 'T'
  1410.           command.  All tagged articles can be untagged by the 'U'
  1411.           untag command.
  1412.  
  1413.           If regex pattern matching is selected you are asked to enter
  1414.           a regular expression (i.e. to match all articles subject
  1415.           lines containing 'net News' you must enter '*net News*').
  1416.           Any articles that match the entered expression will be
  1417.           mailed, piped etc.
  1418.  
  1419.           To save articles to a mailbox with the name of the current
  1420.           newsgroup (i.e. Alt.sources) enter '=' or '=<mailbox name>'
  1421.           when asked for the save filename.
  1422.  
  1423.           To save articles in <newsgroup name>/<filename> format enter
  1424.           '+<filename>'.
  1425.  
  1426.           When saving articles you can specify whether the saved files
  1427.           should be post processed (i.e. unshar shell archive,
  1428.           uudecode multiple parts etc).  A default process type can be
  1429.           set by the 'Process type:' in the 'M' options menu.
  1430.  
  1431.      AAAAUUUUTTTTOOOOMMMMAAAATTTTIIIICCCC MMMMAAAAIIIILLLLIIIINNNNGGGG AAAANNNNDDDD SSSSAAAAVVVVIIIINNNNGGGG NNNNEEEEWWWW NNNNEEEEWWWWSSSS
  1432.           _T_i_n allows new/unread news articles to be mailed (-M
  1433.           option)/saved (-S option) in batch mode for later reading.
  1434.           Useful when going on holiday and you don't want to return
  1435.           and find that expire has removed a whole load of unread
  1436.           articles.  Best to run from crontab everyday while away,
  1437.           after which you will be mailed a report of which articles
  1438.           were mailed/saved from which newsgroups and the total number
  1439.           of articles mailed/saved.  Articles are saved in a private
  1440.           news structure under your <savedir> directory (default is
  1441.           $_H_O_M_E/_N_e_w_s).  Be careful of using this option if you read a
  1442.           lot of groups because you could overflow your filesystem.
  1443.           If you only want to save a few groups it would be best to
  1444.           backup your full $_H_O_M_E/._n_e_w_s_r_c and create a new one that
  1445.           only contains the newsgroups you want to mail/save.  Saved
  1446.  
  1447.  
  1448.  
  1449.      Page 22                                             March 9, 1994
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  1457.  
  1458.  
  1459.  
  1460.           news can be read later by _t_i_n -_R.
  1461.  
  1462.           _t_i_n -_M _i_a_i_n -_c -_f _n_e_w_s_r_c._m_a_i_l
  1463.                               (mail any unread articles in newgroups
  1464.                               specified in file newsrc.mail)
  1465.  
  1466.           _t_i_n -_S -_c -_f _n_e_w_s_r_c._s_a_v_e
  1467.                               (save any unread articles in newgroups
  1468.                               specified in file newsrc.save)
  1469.  
  1470.           _t_i_n -_R              (read any articles saved by _t_i_n -_S)
  1471.  
  1472.      SSSSIIIIGGGGNNNNAAAATTTTUUUURRRREEEESSSS
  1473.           _T_i_n will recognize a signature in either $_H_O_M_E/._s_i_g_n_a_t_u_r_e or
  1474.           $_H_O_M_E/._S_i_g.  If $_H_O_M_E/._s_i_g_n_a_t_u_r_e exists, then the signature
  1475.           will be pulled into the editor for mail commands.  A
  1476.           signature in $_H_O_M_E/._s_i_g_n_a_t_u_r_e will not be pulled into the
  1477.           editor for posting commands since _i_n_e_w_s will append the
  1478.           signature itself.
  1479.  
  1480.           A signature in $_H_O_M_E/._S_i_g will be pulled into the editor for
  1481.           both posting and mailing commands.
  1482.  
  1483.           The following is an example of a $_H_O_M_E/._S_i_g file:
  1484.                NAMES  Iain Lea    iain.lea@erlm.siemens.de
  1485.                SNAIL  Bruecken Strasse 12, 8500 Nuernberg 90, Germany
  1486.                PHONE  +49-911-331963 (home)  +49-911-3089-407 (work)
  1487.           _T_i_n also has the capability to generate random signatures on
  1488.           a per newsgroup basis if so desired. The way to accomplish
  1489.           this is to specify the default signature or the group
  1490.           attribute sigfile as a directory.  If for example the
  1491.           sigfile path is /_u_s_r/_i_a_i_n/._s_i_g_s and ._s_i_g_s is a directory
  1492.           then _t_i_n will select a random signature from any file that
  1493.           is in the directory ._s_i_g_s (note: one signature per numbered
  1494.           file). A random signature can also consist of a fixed part
  1495.           signature that can contain your name, address etc. followed
  1496.           by the random sig. The fixed part of the random sig is read
  1497.           from the file $_H_O_M_E/._s_i_g_f_i_x_e_d.
  1498.  
  1499.      EEEENNNNVVVVIIIIRRRROOOOMMMMEEEENNNNTTTT VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS
  1500.           TTTTIIIINNNNRRRRCCCC
  1501.                Define this variable if you want to specify command
  1502.                line options that _t_i_n should be started with to save
  1503.                typing them each time it is started. The contents of
  1504.                the environment variable are added to the front of the
  1505.                command line options before it is parsed therefore
  1506.                allowing an option specified on the command line to
  1507.                override the same option specified in the environment.
  1508.  
  1509.           TTTTIIIINNNN____HHHHOOOOMMMMEEEEDDDDIIIIRRRR
  1510.                Define this variable if you do not want the .tin
  1511.                directory in $_H_O_M_E/._t_i_n. (i.e. if you want all tin's
  1512.  
  1513.  
  1514.  
  1515.      Page 23                                             March 9, 1994
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  1523.  
  1524.  
  1525.  
  1526.                private files in /_t_m_p/._t_i_n you would set TINDIR to
  1527.                /_t_m_p.
  1528.  
  1529.           TTTTIIIINNNN____IIIINNNNDDDDEEEEXXXXDDDDIIIIRRRR
  1530.                Define this variable if you do not want the .index
  1531.                directory in $_H_O_M_E/._t_i_n/._i_n_d_e_x. (i.e. if you want all
  1532.                tin's index files in /_t_m_p/._i_n_d_e_x you would set
  1533.                TIN_INDEXDIR to /_t_m_p.
  1534.  
  1535.           TTTTIIIINNNN____LLLLIIIIBBBBDDDDIIIIRRRR
  1536.                Define this variable if you want to override the LIBDIR
  1537.                path that was compiled into the tin binary via the
  1538.                Makefile.
  1539.  
  1540.           TTTTIIIINNNN____SSSSPPPPOOOOOOOOLLLLDDDDIIIIRRRR
  1541.                Define this variable if you want to override the
  1542.                SPOOLDIR path that was compiled into the tin binary via
  1543.                the Makefile.
  1544.  
  1545.           TTTTIIIINNNN____NNNNOOOOVVVVRRRROOOOOOOOTTTTDDDDIIIIRRRR
  1546.                Define this variable if you want to override the
  1547.                NOVROOTDIR path that was compiled into the tin binary
  1548.                via the Makefile.
  1549.  
  1550.           TTTTIIIINNNN____AAAACCCCTTTTIIIIVVVVEEEEFFFFIIIILLLLEEEE
  1551.                Define this variable if you want to override the
  1552.                LIBDIR/active path that was compiled into the tin
  1553.                binary via the Makefile.
  1554.  
  1555.           NNNNNNNNTTTTPPPPSSSSEEEERRRRVVVVEEEERRRR
  1556.                The default NNTP server to remotely read news from.
  1557.                This variable only needs to be set if the -r command
  1558.                line option is specified and the file /_e_t_c/_n_n_t_p_s_e_r_v_e_r
  1559.                does not exist.
  1560.  
  1561.           DDDDIIIISSSSTTTTRRRRIIIIBBBBUUUUTTTTIIIIOOOONNNN
  1562.                Set the article header field ``Distribution:'' to the
  1563.                contents of the variable instead of the system default.
  1564.  
  1565.           OOOORRRRGGGGAAAANNNNIIIIZZZZAAAATTTTIIIIOOOONNNN
  1566.                Set the article header field ``Organization:'' to the
  1567.                contents of the variable instead of the system default.
  1568.                This variable has precedence over the file
  1569.                $_H_O_M_E/._t_i_n/_o_r_g_a_n_i_z_a_t_i_o_n that may also contain an
  1570.                organization string.  If reading news on an Apollo
  1571.                DomainOS machine the environment variable NEWSORG has
  1572.                to be used instead of ORGANIZATION.
  1573.  
  1574.           RRRREEEEPPPPLLLLYYYYTTTTOOOO
  1575.                Set the article header field ``Reply-To:'' to the
  1576.                return address specified by the variable.  This is
  1577.                useful if the machine is not registered in the UUCP
  1578.  
  1579.  
  1580.  
  1581.      Page 24                                             March 9, 1994
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  1589.  
  1590.  
  1591.  
  1592.                mail maps or if you wish to receive replies at a
  1593.                different machine.  This variable has precedence over
  1594.                the file $_H_O_M_E/._t_i_n/_r_e_p_l_y_t_o that may also contain a
  1595.                return address.
  1596.  
  1597.           AAAADDDDDDDD____AAAADDDDDDDDRRRREEEESSSSSSSS
  1598.                This can contain an address to append to the return
  1599.                address when replying directly through mail to somebody
  1600.                whose mail address is not directly recognized by the
  1601.                local host.  For example say the return address is
  1602.                _u_s_e_r@_b_i_g_v_a_x, but _b_i_g_v_a_x is not recognized by your host,
  1603.                so therefore the mail will not reach _u_s_e_r.  But the
  1604.                host _l_i_t_t_e_v_a_x is known to recognize your host and
  1605.                _b_i_g_v_a_x, so if ADD_ADDRESS is set (i.e. 'setenv
  1606.                ADD_ADDRESS @littevax' for csh or 'set ADD_ADDRESS
  1607.                @littevax' and 'export ADD_ADDRESS' for sh) the address
  1608.                _u_s_e_r@_b_i_g_v_a_x@_l_i_t_t_l_e_v_a_x will be used and the mail will
  1609.                reach _u_s_e_r@_b_i_g_v_a_x.  This variable has precedence over
  1610.                the file $_H_O_M_E/._t_i_n/_a_d_d__a_d_d_r_e_s_s that may also contain
  1611.                an address.
  1612.  
  1613.           BBBBUUUUGGGG____AAAADDDDDDDDRRRREEEESSSSSSSS
  1614.                If the 'B' command bug report mail address is not
  1615.                correct this variable should be set to the correct mail
  1616.                address.  This variable has precedence over the file
  1617.                $_H_O_M_E/._t_i_n/_b_u_g__a_d_d_r_e_s_s that may also contain a mail
  1618.                address.
  1619.  
  1620.           MMMMAAAAIIIILLLLEEEERRRR
  1621.                This variable has precedence over the default mailer
  1622.                that is used in all mailing operations within _t_i_n (i.e.
  1623.                replying 'rR', and bug reports 'B').
  1624.  
  1625.           VVVVIIIISSSSUUUUAAAALLLL
  1626.                This variable has precedence over the default editor
  1627.                (i.e. vi) that is used in all editing operations within
  1628.                _t_i_n (i.e. posting 'w', replying 'rR', follow-ups 'fF'
  1629.                and bug reports 'B').
  1630.  
  1631.           AAAAUUUUTTTTOOOOSSSSUUUUBBBBSSSSCCCCRRRRIIIIBBBBEEEE
  1632.                _t_i_n interprets this variable similarly to rn.  It
  1633.                contains a list of patterns, separated by commas and
  1634.                possibly prefixed with exclamation points. A new group
  1635.                is checked against the list of patterns; if it matches,
  1636.                _t_i_n subscribes the user to the group without further
  1637.                query. An exclamation point negates the meaning of a
  1638.                match on this pattern, and can be used to cancel
  1639.                certain matches.  For example, setting
  1640.                _A_U_T_O_S_U_B_S_C_R_I_B_E=_c_o_m_p._o_s._u_n_i_x.*,_t_a_l_k.*,!_t_a_l_k._p_o_l_i_t_i_c_s.*
  1641.                will automatically subscribe the user to all new groups
  1642.                in the comp.os.unix hierarchy, and all talk groups
  1643.                other than talk.politics groups (which will be queried
  1644.  
  1645.  
  1646.  
  1647.      Page 25                                             March 9, 1994
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  1655.  
  1656.  
  1657.  
  1658.                for as usual.)
  1659.  
  1660.           AAAAUUUUTTTTOOOOUUUUNNNNSSSSUUUUBBBBSSSSCCCCRRRRIIIIBBBBEEEE
  1661.                _t_i_n interprets this variable similarly to rn.  It is
  1662.                handled like the _A_U_T_O_S_U_B_S_C_R_I_B_E variable, but groups
  1663.                matching the list are unsubscribed from without further
  1664.                query.  For example, setting
  1665.                _A_U_T_O_U_N_S_U_B_S_C_R_I_B_E=_a_l_t._f_l_a_m_e.*,_u*,!_u_k.* will automatically
  1666.                unsubscribe the user from all new alt.flame groups and
  1667.                all groups starting with u (university groups) other
  1668.                than UK groups (which will be queried for as usual.)
  1669.  
  1670.      TTTTIIIIPPPPSSSS AAAANNNNDDDD TTTTRRRRIIIICCCCKKKKSSSS
  1671.           Tin can be pretty much be navigated by using the four cursor
  1672.           keys. The left arrow key goes up a level, the right arrow
  1673.           key goes down a level, the up arrow key goes up a line (page
  1674.           at article viewer level) and the down arrow key goes down a
  1675.           line (page at article viewer level).
  1676.  
  1677.           The following newsgroups provide useful information
  1678.           concerning news software:
  1679.               -news.software.readers (info. about news user agents
  1680.                tin,rn,nn,vn etc.)
  1681.               -news.software.nntp (info. about NNTP)
  1682.               -news.software.b (info. about news transport agents
  1683.                Bnews,Cnews and INN)
  1684.               -news.answers (Frequently Asked Questions (FAQ) about
  1685.                many different themes)
  1686.  
  1687.           Many prompts (i.e. 'Mark everything as read? (y/n): y')
  1688.           within _t_i_n offer a default choice that the cursor is
  1689.           positioned on.  By pressing <CR> the default value is taken.
  1690.  
  1691.           Many prompts (i.e. 'Post subject []>') within _t_i_n can be
  1692.           aborted by pressing ESC.
  1693.  
  1694.           When _t_i_n is run in an xterm window it will resize itself
  1695.           each time the xterm is resized.
  1696.  
  1697.           _T_i_n will reread the active file at set intervals to show any
  1698.           newly arrived news.
  1699.  
  1700.      XXXXTTTTEEEERRRRMMMM BBBBUUUUTTTTTTTTOOOONNNNSSSS
  1701.           If the environment variable _T_E_R_M is set to _x_t_e_r_m, then
  1702.           button pressing can be used to select groups and articles.
  1703.  
  1704.           In the group selection menu, if the mouse is pointing before
  1705.           the groups listing region the previous page is selected
  1706.           (just like b).  If the mouse is pointing after the groups
  1707.           listing region the next page is selected (just like space).
  1708.           If the mouse is pointing at a group then:
  1709.  
  1710.  
  1711.  
  1712.  
  1713.      Page 26                                             March 9, 1994
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  1721.  
  1722.  
  1723.  
  1724.           left button    moves to the group pointed at.
  1725.  
  1726.           other buttons  moves to and selects the group pointed at.
  1727.                          Just like <CR>.
  1728.  
  1729.           In the article menu, if the mouse is pointing before the
  1730.           article listing region the previous page is selected (just
  1731.           like b).  If the mouse is pointing after the article listing
  1732.           region the next page is selected (just like space).  If the
  1733.           mouse is pointing at an article then:
  1734.  
  1735.           left button    moves to the article pointed at.
  1736.  
  1737.           centre button  reads next unread article from that pointed
  1738.                          at.  Just like <TAB>.
  1739.  
  1740.           right button   reads article pointed at.  Just like <CR>.
  1741.  
  1742.           In the thread menu, if the mouse is pointing before the
  1743.           article listing region the previous page is selected (just
  1744.           like b).  If the mouse is pointing after the article listing
  1745.           region the next page is selected (just like space).  If the
  1746.           mouse is pointing at an article then:
  1747.  
  1748.           left button    moves to the article pointed at.
  1749.  
  1750.           centre button  reads next unread article from that pointed
  1751.                          at.  Just like <TAB>.
  1752.  
  1753.           right button   reads article pointed at.  Just like <CR>.
  1754.  
  1755.           In the spool selection menu, if the mouse is pointing before
  1756.           the spool listing region the previous page is selected (just
  1757.           like b).  If the mouse is pointing after the spool listing
  1758.           region the next page is selected (just like space).  If the
  1759.           mouse is pointing at a spool selection then:
  1760.  
  1761.           left button    moves to the spool pointed at.
  1762.  
  1763.           other buttons  moves to and selects the spool pointed at.
  1764.                          Just like <CR>.
  1765.  
  1766.           In other menus and areas button pressing reverts back to
  1767.           usual cut and paste of xterm, but after one click of any
  1768.           button.
  1769.  
  1770.      FFFFIIIILLLLEEEESSSS
  1771.           $_H_O_M_E/._n_e_w_s_r_c       subscribed to newgroups.
  1772.  
  1773.           $_H_O_M_E/._n_e_w_s_a_u_t_h     ``nntpserver password'' pairs for NNTP
  1774.                               servers that require authorization.
  1775.  
  1776.  
  1777.  
  1778.  
  1779.      Page 27                                             March 9, 1994
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  1787.  
  1788.  
  1789.  
  1790.           $_H_O_M_E/._t_i_n/_t_i_n_r_c    options.
  1791.  
  1792.           $_H_O_M_E/._t_i_n/_a_t_t_r_i_b_u_t_e_s
  1793.                               contains user specified group
  1794.                               attributes.
  1795.  
  1796.           $_H_O_M_E/._t_i_n/._i_n_d_e_x   newsgroups index files directory.
  1797.  
  1798.           $_H_O_M_E/._t_i_n/._m_a_i_l_i_d_x mailgroups index files directory.
  1799.  
  1800.           $_H_O_M_E/._t_i_n/._s_a_v_e_i_d_x saved newsgroups index files directory.
  1801.  
  1802.           $_H_O_M_E/._t_i_n/_a_c_t_i_v_e._m_a_i_l
  1803.                               active file of users mailgroups.
  1804.  
  1805.           $_H_O_M_E/._t_i_n/_a_c_t_i_v_e._s_a_v_e
  1806.                               active file of users saved newsgroups.
  1807.  
  1808.           $_H_O_M_E/._t_i_n/_a_d_d__a_d_d_r_e_s_s
  1809.                               address to add to when replying through
  1810.                               mail.
  1811.  
  1812.           $_H_O_M_E/._t_i_n/_b_u_g__a_d_d_r_e_s_s
  1813.                               address to send bug reports to.
  1814.  
  1815.           $_H_O_M_E/._t_i_n/_k_i_l_l     article kill and auto-selection file.
  1816.  
  1817.           $_H_O_M_E/._t_i_n/_o_r_g_a_n_i_z_a_t_i_o_n
  1818.                               string to replace default organization.
  1819.  
  1820.           $_H_O_M_E/._t_i_n/_p_o_s_t_e_d   history of articles posted by user.
  1821.  
  1822.           $_H_O_M_E/._t_i_n/_r_e_p_l_y_t_o  host address to use in ``Reply-To:''
  1823.                               mail header.
  1824.  
  1825.           $_H_O_M_E/._s_i_g_n_a_t_u_r_e    signature.
  1826.  
  1827.           $_H_O_M_E/._S_i_g          signature.
  1828.  
  1829.           $_H_O_M_E/._s_i_g_f_i_x_e_d     fixed part of a randomly generated
  1830.                               signature.
  1831.  
  1832.           /_u_s_r/_l_i_b/_n_e_w_s/_m_o_t_d  News message of the day file.
  1833.  
  1834.           /_u_s_r/_l_i_b/_n_e_w_s/_n_e_w_s_g_r_o_u_p_s
  1835.                               Short description of all newsgroups.
  1836.  
  1837.           /_u_s_r/_l_i_b/_n_e_w_s/_s_u_b_s_c_r_i_p_t_i_o_n_s
  1838.                               List of newsgroups to subscribe first
  1839.                               time user to.
  1840.  
  1841.      BBBBUUUUGGGGSSSS
  1842.  
  1843.  
  1844.  
  1845.      PPPPaaaaggggeeee 22228888                                             MMMMaaaarrrrcccchhhh 9999,,,, 1111999999994444
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  1853.  
  1854.  
  1855.  
  1856.           There are bugs somewhere among the creeping featurism.  Any
  1857.           bugs found should be reported by the 'B' (bug report)
  1858.           command.
  1859.  
  1860.           Coredumps when setting certain toggle options from the
  1861.           options menu at article viewer level.
  1862.  
  1863.           Coredumps when killing last article in a thread at article
  1864.           viewer level.
  1865.  
  1866.      HHHHIIIISSSSTTTTOOOORRRRYYYY
  1867.           Based on the _t_a_s_s newsreader that was developed by Rich
  1868.           Skrenta and posted to alt.sources in March 1991.  Tass was
  1869.           itself heavily influenced by NOTES which was developed at
  1870.           the University of Illinois by Ray Essick and Rob Kolstad in
  1871.           1982.
  1872.  
  1873.           v1.0 PL0 (full) was posted in 8 parts to alt.sources on 23
  1874.           Aug 1991.
  1875.           v1.0 PL1 (full) was posted in 8 parts to alt.sources on 03
  1876.           Sep 1991.
  1877.           v1.0 PL2 (full) was posted in 9 parts to alt.sources on 24
  1878.           Sep 1991.
  1879.           v1.0 PL3 (patch) was posted in 4 parts to alt.sources on 30
  1880.           Sep 1991.
  1881.           v1.0 PL4 (patch) was posted in 2 parts to alt.sources on 02
  1882.           Oct 1991.
  1883.           v1.0 PL5 (patch) was posted in 4 parts to alt.sources on 17
  1884.           Oct 1991.
  1885.           v1.0 PL6 (patch) was posted in 5 parts to alt.sources on 27
  1886.           Nov 1991.
  1887.           v1.0 PL7 (patch) was posted in 2 parts to alt.sources on 27
  1888.           Nov 1991.
  1889.           v1.1 PL0 (full) was posted in 11 parts to alt.sources on 13
  1890.           Feb 1992.
  1891.           v1.1 PL1 (full) was posted in 12 parts to alt.sources on 24
  1892.           Mar 1992.
  1893.           v1.1 PL2 (patch) was posted in 4 parts to alt.sources on 30
  1894.           Mar 1992.
  1895.           v1.1 PL3 (full) was posted in 15 parts to alt.sources on 13
  1896.           May 1992.
  1897.           v1.1 PL4 (full) was posted in 15 parts to alt.sources on 22
  1898.           Jun 1992.
  1899.           v1.1 PL5 (patch) was posted in 7 parts to alt.sources on 11
  1900.           Aug 1992.
  1901.           v1.1 PL6 (full) was posted in 15 parts to alt.sources on 14
  1902.           Sep 1992.
  1903.           v1.1 PL7 (patch) was posted in 10 parts to alt.sources on 15
  1904.           Nov 1992.
  1905.           v1.1 PL8 (patch) was posted in 6 parts to alt.sources on 06
  1906.           Dec 1992.
  1907.           v1.1 PL9 (patch) was posted in 3 parts to alt.sources on 20
  1908.  
  1909.  
  1910.  
  1911.      Page 29                                             March 9, 1994
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  1919.  
  1920.  
  1921.  
  1922.           Mar 1993.
  1923.           v1.2 PL0 (full) was posted in 14 parts to alt.sources on 25
  1924.           May 1993.
  1925.           v1.2 PL1 (patch) was posted in 8 parts to alt.sources on 14
  1926.           Jul 1993.
  1927.           v1.2 PL2 (patch) was posted in ?? parts to alt.sources on ??
  1928.           Sep 1993.
  1929.  
  1930.      CCCCRRRREEEEDDDDIIIITTTTSSSS
  1931.           Rich Skrenta   author of tass v3.2 which this newsreader
  1932.                          used as its base.
  1933.  
  1934.           Bill Davidsen  author of envarg.c environment variable
  1935.                          reading routine.
  1936.  
  1937.           Mike Gleason   author of sigfile.c random signature
  1938.                          generation routines.  Arnold Robbins author
  1939.                          of strftime.c date formatting routine.
  1940.  
  1941.           Jim Robinson   co-author of kill.c article kill and auto-
  1942.                          selection routines.
  1943.  
  1944.           Rich Salz      author of wildmat.c pattern matching and
  1945.                          parsedate.y date parsing routines.
  1946.  
  1947.           Dave Taylor    author of curses.c from the elm mailreader.
  1948.  
  1949.           Chris Thewalt  author of getline.c emacs style editing
  1950.                          routine.
  1951.  
  1952.           Mark Tomlinson for porting _t_i_n to the AmigaDOS operating
  1953.                          system.
  1954.  
  1955.           Andreas Wrede  for porting _t_i_n to the OS/2 operating system.
  1956.  
  1957.           Dieter Becker  for generously posting certain releases for
  1958.                          me when my net connection was removed by a
  1959.                          group of very short sighted people.
  1960.  
  1961.           I wish to thank the following people for supplying patches:
  1962.  
  1963.           David Abbott, Earle Ake, Joachim Astel, Anton Aylward,
  1964.           George Baltz, Paul Bauwens, Dieter Becker, Dan Berry, David
  1965.           Binderman, Fokke de Boer, Mark Boucher, Herman ten Brugge,
  1966.           Leila Burrell-Davis, Peter Castro, Robert Claeson, Steven
  1967.           Cogswell, Don Costello, Bryan Curnutt, Ned Danieley, Chris
  1968.           Davies, John Davis, Tom Dickey, Bryan Dongray, Craig
  1969.           Durland, Kirk Edson, Stefan Elf, Rob Engle, Brent Ermlick,
  1970.           Olle Eriksson, Michael Faurot, Werner Fleck, Callum Gibson,
  1971.           Mike Glendinning, Philippe Goujard, Carl Hage, Paul Halsema,
  1972.           Ed Hanway, Scott Hauck, Per Headland, Daniel Hermans, Jose
  1973.           Herrero, Tom Hite, Torsten Homeyer, Tommy Hsieh, Steve Hunt,
  1974.  
  1975.  
  1976.  
  1977.      Page 30                                             March 9, 1994
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.      TTTTIIIINNNN((((1111))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((VVVVeeeerrrrssssiiiioooonnnn 1111....2222 PPPPLLLL2222))))           TTTTIIIINNNN((((1111))))
  1985.  
  1986.  
  1987.  
  1988.           Pieter Immelman, Robbin Johnson, Nelson Kading, Fritz
  1989.           Kleeman, Dwarven Knight, Karl-Koenig Koenigsson, Martin
  1990.           Kraemer, Kris Kugel, Geoff Lane, Alex Lange, Alain Lasserre,
  1991.           Marty Leisner, Hakan Lennestal, Otto Lind, Richard Lloyd,
  1992.           Clifford Luke, David MacKenzie, Hugh Mahon, Kazushi
  1993.           Marukawa, Owen Medd, Soren Moller, Sergio Morales, Michael
  1994.           Morrell, Klaus Mueller, Udo Munk, James Nugen, Jeb Palmer,
  1995.           Neil Parker, Tom Parry, Jim Patterson, Walter Pelissero,
  1996.           Colin Perkins, Eric Peterson, Tim Pierce, Bill Poitras,
  1997.           Wolfgang Prediger, Ted Richards, Ollivier Robert, Jim
  1998.           Robinson, Stephen Roseman, Clifton Royston, Nickolay Saukh,
  1999.           Rich Salz, Gary Sanders, John Sauter, Christopher Sawtell,
  2000.           John Schmitz, Bart Sears, Karl-Olav Serrander, Doug Sewell,
  2001.           Philip Shearer, Mark Smith, Steve Spearman, Cliff Stanford,
  2002.           Steve Starck, Jason Steiner, Ed Sznyter, Derek Terveer,
  2003.           Julian Thompson, Andry Timonin, Mark Tomlin, Michael Traub,
  2004.           Adri Verhoef, Paul Vickers, Cary Whitney, Greg Woods, Lloyd
  2005.           Wright
  2006.  
  2007.           I wish to thank the following people for bug
  2008.           reports/comments:
  2009.  
  2010.           Jack Applin, Klaus Arzig, Scott Babb, Reiner Balling,
  2011.           Preston Bannister, Bill de Beabien, Volker Beyer, Etienne
  2012.           Bido, Roger Binns, Georg Biehler, Jean-Marc Bonnaudet, Eric
  2013.           Bowles, Sean Brady, Ian Brown, Andreas Brosig, Craig Bruce,
  2014.           Brett Carver,Tom Czarnik, Dave Datta, Mat Davis, Karl
  2015.           Denninger, Klaus Dimmler, David Donovan, Peter Dressler,
  2016.           Gerhard Ermer, Hugh Fader, Miguel Farah, Joachim Feld, Paul
  2017.           Fox, Jay Geertsen, Herschel Gelman, Bernhard Gmelch, Jason
  2018.           Haar, Viet Hoang, Andy Jackson, Joe Johnson, Ralph Jud,
  2019.           Cyrill Jung, Kuo-Chein Kai, Tonis Kelder, Hans-Juergen
  2020.           Knopp, Sridhar Komandur, Tom Kovar, Bernhard Kroenung,
  2021.           Murray Laing, Per Lindqvist, Eric Litman, Bob Lukas, Michael
  2022.           Marshall, Kazushi Marukawa, Olaf Mittelstaedt, Phillip
  2023.           Molloy, Phil Molyneux, Toni Metz, Greg Miller, Deeptendu
  2024.           Majumder, Klaus Neuberger, Otto Niesser, Reiner Oelhaf, Alex
  2025.           Pakter, John Palkovic, Dave Pascoe, Wolf Paul, Andrew
  2026.           Phillips, Stefan Rathmann, Jon Robinson, David Ross, Jonas
  2027.           Rwgmyr, Malkani Sanjay, Daemon Schaefer, Dean Schrimpf,
  2028.           Klamer Schutte, Fredy Schwatz, Dave Schweisguth, Bernd
  2029.           Schwerin, Don Sheythe, Chris Smith, Daniel Smith, Richard
  2030.           Stanton, Ralf Stephan, Hironobu Takahashi, Ken Taylor, Tony
  2031.           Travis, Paul Verket, Sven Werner, Dick Wexelblat, Paul Wood,
  2032.           Gregory Woodbury, Norm Yamane, Blair Zajac, Orest Zboroski,
  2033.           Thomas Ziegler
  2034.  
  2035.      AAAAUUUUTTTTHHHHOOOORRRR
  2036.           Iain Lea  (iain.lea@erlm.siemens.de)
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.      Page 31                                             March 9, 1994
  2044.  
  2045.  
  2046.  
  2047.